ReserveSectionID

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODLinkManager

ReserveSectionID
Document Shell
Mac OS
The ReserveSectionID method reserves a section ID for the lifetime of the document of the specified draft.
ODBoolean ReserveSectionID (in ODULong sectionID, 
                            in ODDraft draft);
sectionID
The section ID to be reserved.
draft
A reference to the draft in which to reserve the section ID.
return value
kODTrue if the specified section ID is not in use and not already reserved, otherwise kODFalse.

DISCUSSION
This method guarantees that the specified section ID will not be issued by the NewSectionID method for the lifetime of the document. If this method returns false, the caller should request a different ID or call the NewSectionID method.

SEE ALSO
The ODLinkManager::NewSectionID method (page 368).